home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / DATABASE / GETPOS.ZIP / GETPOS.DOC < prev    next >
Text File  |  1993-08-25  |  5KB  |  114 lines

  1.  
  2. ºTopic0001
  3. {\f0 \fs48 \cf9 \B \i Window 
  4. Sizer 
  5. Help}
  6.  
  7. ñ{\f0 \fs20 \cf6 Introduction}½Topic0002╗
  8. ñ{\f0 \fs20 \cf6 Definitions}½Topic0003╗
  9.  
  10.  
  11. {\f0 \fs18 \cf1 Written by:  Brendan Delumpa
  12. Benson Software Systems, Inc. (415)433-200
  13. CompuServe ID 72410,520}
  14.  
  15. ºTopic0002
  16. {\f0 \fs24 \cf9 \B Introduction}
  17.  
  18. This Windows help file was created using a help authoring tool called 
  19. Help Edit.  With Help Edit, assembling the file took about an eighth of the 
  20. time it normally took me because I didn't have to write my own RTF 
  21. file or HPJ file.  For any one who needs to write help systems in Windows,
  22. this program comes highly recommended.
  23.  
  24. If you're familiar with WinSize, then you're already familiar with what 
  25. getPos does with regards to fetching window size coordinates.  However, 
  26. I wrote getPos long before WinSize was available in response to the 
  27. lack of a sizing utility in Paradox.  But in addition to fetching window 
  28. size values, I wanted to be able to dynamically size windows from getPos. 
  29.  
  30. Included are all the files I used to create getPos.  I also included all the
  31. files used to create this help file so you can see what it takes.  If you
  32. have any questions, please contact me at the number above, or send
  33. me mail via CIS.
  34.  
  35. Brendan
  36.  
  37. ºTopic0003
  38. {\f0 \fs24 \cf9 \B Definitions}
  39.  
  40. { \f0 \fs18 \cf1 Click on one of the selections to bring up a list of defined items on the Window Sizer Form.}
  41.  
  42. ñ{\f0 \fs20 \cf6 Key Combinations}½Topic0004╗
  43. ñ{\f0 \fs20 \cf6 Field Object Definitions}½Topic0005╗
  44. ñ{\f0 \fs20 \cf6 pushButtons}½Topic0009╗
  45.  
  46.  
  47. ºTopic0004
  48. {\f0 \fs24 \cf9 \B Key Combinations}
  49.  
  50. I've included some Alt-<key> combinations with getPos to make it easier to use the form.  You'll notice that the key combinations are non-standard, or perhaps, even illogical key assignments.  This is because getPos is NOT MODAL, which means that everything in Paradox is available to the designer, and that includes menus, which can also be accessed with Alt-<key> combinations.  Below is the list of valid key combinations in getPos: 
  51.  
  52. Alt-O     Open Selected Form
  53. Alt-I     File Information
  54. Alt-P    Clipboard Copy
  55. Alt-D    Reset Coordinates
  56. Alt-C    Close getPos
  57.  
  58.  
  59.  
  60. ºTopic0005
  61. {\f0 \fs24 \cf9 \B Field Object Definitions}
  62.  
  63. {\f0 \fs18 \cf1 The following contain specific descriptions on purpose and usage of each object within the form.  While no ObjectPAL example are present, the concept is presented.}
  64.  
  65. ñ{\f0 \fs20 \cf6 Form Name}½Topic0007╗
  66. ñ{\f0 \fs20 \cf6 Coordinate and Size : X, Y, Width, Height}½Topic0008╗
  67.  
  68.  
  69. ºTopic0007
  70. {\f0 \fs24 \cf9 \B Form Name Field}
  71. The Form Name Field is a list box object that contains the valid form names for the current directory.  The values are inserted into the list box at form open.  The open method calls a custom method called getFileList() which performs an enumFileList("*.fsl",dForms).  dForms is a dynamic array that's defined in the Var method of the form.  The dynArray values are then passed into the list box values through a FOR loop. 
  72.  
  73. ºTopic0008
  74. {\f0 \fs24 \cf9 \B Coordinate and Size Fields}
  75. The coordinate and size fields (denoted by X, Y, Width, and Height) define the position and size of the selected form when it's opened.  These fields may be left blank when opening a form.  When left blank, once the called form is closed, its default position and size are returned to Window Sizer and Positioner and the corresponding values are returned to the fields.  This helps in gauging the amount needed to be increased or decreased to current values.
  76.  
  77. ºTopic0009
  78. {\f0 \fs24 \cf9 \B PushButtons and Features}
  79.  
  80. The following are a list of features available in the utility:
  81.  
  82. ñ{\f0 \fs20 \cf6 Windows Help Facility}½Topic0011╗
  83. ñ{\f0 \fs20 \cf6 Open Selected Form}½Topic0012╗
  84. ñ{\f0 \fs20 \cf6 File Information}½Topic0013╗
  85. ñ{\f0 \fs20 \cf6 Copy Coordinates to Clipboard}½Topic0014╗
  86. ñ{\f0 \fs20 \cf6 Coordinate Reset to Blank}½Topic0015╗
  87. ñ{\f0 \fs20 \cf6 Close}½Topic0016╗
  88.  
  89.  
  90. ºTopic0011
  91. {\f0 \fs24 \cf9 \B Help File}
  92. This file explains the features and functions of the various objects contained in the utility.  Short definitions are made with references to ObjectPAL to give people an idea of what is going on behind the scenes in the form. 
  93.  
  94. ºTopic0012
  95. {\f0 \fs24 \cf9 \B Open Selected Form}
  96. The Open button opens up the selected form from the picklist, and places it on the workspace.  In addition to opening the form, it grabs the current getPosition() parameters and inserts them into the appropriate fields.  This gives the developer a way of gauging how much a window must be sized or moved. 
  97.  
  98. ºTopic0013
  99. {\f0 \fs24 \cf9 \B DOS File Information}
  100. This simply brings up a form that contains DOS file information.  The form's table is loaded using the second form of enumFileList() which writes the file information to a user-defined table. 
  101.  
  102. ºTopic0014
  103. {\f0 \fs24 \cf9 \B Copy Coordinates to Clipboard}
  104. Pressing this button will copy the currently display coordinates to the clipboard. 
  105. {\f0 \fs20 \cf1 \i  Hint:  If you open up the form again immediately after copying, you go into Design Mode and enter in the setPosition method in the Open method of the form.}
  106.  
  107. ºTopic0015
  108. {\f0 \fs24 \cf9 \B Reset Coordinates and Sizes}
  109. This clears all the coordinate and size parameters.  It's much easier than deleting the values field-by-field.
  110.  
  111.  
  112. ºTopic0016
  113. {\f0 \fs24 \cf9 \B Close}
  114. This will close the getPosition Form.